home *** CD-ROM | disk | FTP | other *** search
/ The 640 MEG Shareware Studio 2 / The 640 Meg Shareware Studio CD-ROM Volume II (Data Express)(1993).ISO / door / usa12.zip / USA.DOC < prev    next >
Text File  |  1992-07-05  |  9KB  |  236 lines
  1.  
  2.  
  3.                                  USA DOOR
  4.     
  5.                                   V.1.2
  6.  
  7.  
  8.  
  9.                             Release Version 1.2
  10.                      Copyright (c) 1991  Gary R. Smith
  11.                             All Rights Reserved
  12.  
  13.  
  14.         DISCLAIMER
  15.  
  16.  
  17.         There is made no warranty of any kind, express or implied,
  18.         including without limitation, any warranties of merchantability
  19.         and/or fitness for a particular purpose. I shall not be liable
  20.         for any damages, whether direct, indirect, special or on
  21.         sequential arising from a failure of this program to operate in
  22.         the manner desired by the user.  I shall not be liable for any
  23.         damage to data or property which may be caused directly or
  24.         indirectly by the use of this program.
  25.  
  26.         IN NO EVENT WILL I BE LIABLE TO YOU FOR ANY DAMAGES, INCLUDING
  27.         ANY LOST PROFITS, LOST SAVINGS OR OTHER INCIDENTAL OR
  28.         CONSEQUENTIAL DAMAGES ARISING OUT OF YOUR USE OR INABILITY TO USE
  29.         THE PROGRAM, OR FOR ANY CLAIM BY ANY OTHER PARTY.
  30.  
  31.  
  32.         If you would like to keep the latest version of the USA DOOR on
  33.         your system, you can download the latest version from one of our
  34.         Support Boards or your favorite Quality BBS System.
  35.  
  36.                  Random Access, (Computer Profile's Support Board)
  37.                                 Marietta, Georgia
  38.                             (404) 516-7150 (14.4 HST)
  39.  
  40.  
  41.         What it does -  The USA door will allow your users to view the
  42.         USA TODAY news online. This door breaks the newspaper down into
  43.         a systematic way so that it easier to get to each section of the
  44.         paper. The USA DOOR gives your board a look and feel of excellence
  45.         and sophistication. Give it a try and see it doesnt make your
  46.         reading of the morning paper that much easier and enjoyable.
  47.  
  48.  
  49. ------- Required for operation (USATODAY.ZIP)
  50.  
  51.  
  52.         Features of USA Door:
  53.     
  54.  
  55.         o Works with most door formats including PCBoard.sys, Door.sys
  56.           sfdoors.dat etc...
  57.  
  58.         o Displays in color / non - color modes!
  59.  
  60.         o Detects Loss of carrier!
  61.  
  62.         o Can operate at speeds in excess of 115000 Baud!
  63.  
  64.         o Will automatically log user off after 3 minutes of no keyboard
  65.           activity!
  66.  
  67.         o Can be operated on a Multi-Networked Board!
  68.  
  69.         o Written completely in Borland C++! 
  70.  
  71.  
  72.         Getting Started:
  73.         
  74.         Setting up USA is a very simple process. If you have set
  75.         up other doors then you will have no problems. Computer Profile
  76.         doors follow the system standards as setforth by PCBoard.
  77.  
  78. STEP BY STEP
  79. ------------
  80.  
  81.  
  82. SETTING IT UP - (This example sets up a Single Node PCBoard 14.5 setup. If 
  83. you are running a different type of BBS software, set the door up according 
  84. to your BBS specifications. It should be very similiar to this example)
  85.  
  86. /*------------------------------------------------------------------------
  87. Step 1: (Creating a directory)
  88.  
  89.             Create a directory from which USA will run from.
  90.           This Directory can be called anything you wish that is
  91.           within the DOS 8 character limit.  (This document will
  92.           assume you have selected C:\PCB\DOORS\USA for the remainder 
  93.           of the examples).
  94.  
  95. /*------------------------------------------------------------------------
  96. Step 2: (Copy the files)
  97.  
  98.           Copy or UNZIP all the USA files into the directory you 
  99.           just created above.
  100.  
  101.                          ex.    COPY USA1.ZIP C:\PCB\DOORS\USA
  102.                                 PKUNZIP USA1.ZIP
  103. /*------------------------------------------------------------------------
  104. Step 3: (Create the Configuration file, USA.CNF)
  105.         
  106.           Create the USA configuration file. This file will contain 
  107.           all the external data that USA will use. Using your ascii
  108.           editor you will create a text file called "USA.CNF". The name 
  109.           cannot be changed and it MUST be placed in your USA Directory. 
  110.           If this file is not found a message is written to the screen 
  111.           and the program is exited.
  112.  
  113.                   The below is a Description of each line required
  114.                   Example - (USA.CNF)
  115.  
  116.                   Line 1  Random Access        ( Bulletin Board Name)
  117.                   Line 2  99999                ( Registration Number)
  118.  
  119.  
  120. /*-------------------------------------------------------------------------
  121. STEP 4: (Construct the batch file)
  122.  
  123.           You now need to construct the batch file that PCBoard will use to 
  124.           call the USA program. If your running multi-node you may 
  125.           want to use the PCBoard enviornment variables provided by pcboard
  126.           14.5+.
  127.  
  128.           By creating this batch file you are configuring it so USA will run
  129.           for that node. Each batch file you create should be like the 
  130.           following example. (Assuming we are configuring for a single 
  131.           Node) 
  132.        
  133.           USA -  (PCBoard Version)
  134.  
  135.           Line 1    @ECHO OFF
  136.           Line 2    CD C:\PCB\DOORS\USA
  137.           Line 3    USA C:\PCB\PCBOARD.SYS 
  138.           Line 4    CD C:\PCB
  139.           Line 5    BOARD
  140.  
  141.           USA -  (PCBoard Multinode Version)
  142.  
  143.           Line 1    @ECHO OFF
  144.           Line 2    CD C:\PCB\DOORS\USA
  145.           Line 3    USA.EXE %PCBDRIVE%PCBDIR%\PCBOARD.SYS
  146.           Line 4    CD %PCBDIR%
  147.           Line 5    BOARD
  148.  
  149.  
  150.           USA - (Other BBS Version)
  151.  
  152.           Line 1    @ECHO OFF
  153.           Line 2    CD C:\BBSDIR\DOORS\USA
  154.           Line 3    USA C:\BBSDIR\DOOR.SYS
  155.           Line 4    CD C:\BBSDIR
  156.           Line 5    BBS COMMAND
  157.  
  158.  
  159.                 Line 1 Turns off the Local Screen Echo (DOS 3.3 and up)
  160.                 Line 2 Changes the directory to where USA is stored
  161.                 Line 3 (1) USA Executable Statement
  162.                        (2) The complete path to that nodes PCBoard.sys, 
  163.                            DOOR.sys, Generic.sys file
  164.                 Line 4 Changes the directory back to the BBS directory
  165.                 Line 5 Calls the PCBoard program / or your bbs program
  166.  
  167.        NOTE: Your USA batch file should be similar to the example above, 
  168.              Line 3 however, Must contain the path to the pcboard.sys 
  169.              or door.sys type file.
  170.  
  171.  
  172. * IMPORTANT *
  173.  
  174.         This file is to be placed in the PCBoard or BBS directory.
  175.  
  176. /*------------------------------------------------------------------------
  177. STEP 6: (Adding USA to the Doors File)
  178.  
  179.           The next step to setting up is to add USA to your PCBoard 
  180.           Doors file. This is done through the PCBoard setup program. All 
  181.           you need to do once you are in the PCBSETUP editor for doors is 
  182.           place the name of the batch file you just created above in a slot 
  183.           for a door, give it a minimum security level and your all done. 
  184.  
  185. /*------------------------------------------------------------------------
  186. STEP 7: (Utilizing the USA Today Zip files)
  187.  
  188.          In order for USA to run properly it must be able to find the USA
  189.          Today files. You should do something like the following...This is
  190.          a part of an automated batch file.
  191.  
  192.          cd c:\uploads
  193.          pkunzip -o USATODAY.ZIP C:\PCB\DOORS\USA
  194.          del usatoday.zip
  195.          .
  196.          .
  197.          continue with batch files.
  198.  
  199.          You should always use the -O option of pkunzip. This will over
  200.          write all the old USA Today files already in your USA directory.
  201.  
  202.  
  203.          ** ALL USATODAY FILES MUST BE IN YOUR USA DIRECTORY IN ORDER FOR
  204.             USA TO WORK PROPERLY.
  205.  
  206. /*------------------------------------------------------------------------
  207.  
  208. RUNNING USA
  209.  
  210.          Just type USA from the command line and your off and running. There
  211.          is nothing hard about this door, and it will run with all bbs
  212.          types.
  213.  
  214. /*------------------------------------------------------------------------
  215.  
  216. For those of you that understand Ports and IRQ settings!
  217.  
  218. NOTE: If you need to specify a non-standard port address and IRQ, 
  219. then the syntax is PORT:AAAA:X where AAAA is the base address and X is the 
  220. IRQ. It doesn't matter whether PORT:AAAA:X is the third  or foruth parameter 
  221. as long as it is the LAST parameter passed.
  222.  
  223. PORT is optional, and USA will default to standard addresses and irqs 
  224. if it not used based on the port number read from the BBS file.
  225. USA will assume COM1 = 03F8 IRQ 4, COM2 = 02E8 IRQ3, COM3 = 03E8 IRQ4
  226. and COM4 = 02E8 IRQ 3.  If you have a different non-standard port address and 
  227. irq, you could then use the PORT cmd to change the defaults.  
  228.  
  229. USA will also support the use of FOSSIL drivers.  The syntax for a FOSSIL 
  230. driver is: PORT:F:P. The 'F' tells USA to use a Fossil driver for it's 
  231. communications.  The 'P' following it tells it which port to use for
  232. the Fossil. Example - PORT:F:1, tells USA to use a fossil driver for
  233. port 1. 
  234.  
  235.         
  236.